home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audio / ALgetqueuesize.z / ALgetqueuesize
Encoding:
Text File  |  1998-10-20  |  6.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. AAAALLLLggggeeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm))))                                        AAAALLLLggggeeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ALgetqueuesize, ALsetqueuesize - (obsolete) get/set audio port buffer
  10.      size information in an AAAALLLLccccoooonnnnffffiiiigggg structure
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  14.  
  15.      lllloooonnnngggg AAAALLLLggggeeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg))))
  16.      iiiinnnntttt AAAALLLLsssseeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg,,,, ccccoooonnnnsssstttt lllloooonnnngggg ssssiiiizzzzeeee))))
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  19.      _c_o_n_f_i_g   expects an AAAALLLLccccoooonnnnffffiiiigggg structure.  This structure is the returned
  20.               value of an AAAALLLLnnnneeeewwwwccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) or AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) call.
  21.  
  22.      _s_i_z_e     expects the number of sample locations to use for the internal
  23.               buffer of an audio port created by a subsequent AAAALLLLooooppppeeeennnnppppoooorrrrtttt((((3333ddddmmmm))))
  24.               call.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      AAAALLLLggggeeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee and AAAALLLLsssseeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee are obsolete and provided for backward
  28.      compatibility. The preferred functions are aaaallllGGGGeeeettttQQQQuuuueeeeuuuueeeeSSSSiiiizzzzeeee((((3333ddddmmmm)))) and
  29.      aaaallllSSSSeeeettttQQQQuuuueeeeuuuueeeeSSSSiiiizzzzeeee((((3333ddddmmmm)))), both of which use units of sample frames.
  30.  
  31.      AAAALLLLggggeeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm)))) returns the number of sample locations that the
  32.      AAAALLLLccccoooonnnnffffiiiigggg structure specifies.
  33.  
  34.      AAAALLLLsssseeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm)))) changes the number of sample locations that _c_o_n_f_i_g
  35.      specifies.  Later, when you call AAAALLLLooooppppeeeennnnppppoooorrrrtttt((((3333ddddmmmm)))) with this _c_o_n_f_i_g
  36.      structure, an audio port is created with an internal buffer of _s_i_z_e
  37.      sample locations.
  38.  
  39.  
  40.      AAAALLLLggggeeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm)))) can fail for the following reason:
  41.  
  42.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG   _c_o_n_f_i_g is invalid or null.
  43.  
  44.  
  45.      AAAALLLLsssseeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm)))) can fail for the following reasons:
  46.  
  47.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG   _c_o_n_f_i_g is invalid or null.
  48.  
  49.      AAAALLLL____BBBBAAAADDDD____QQQQSSSSIIIIZZZZEEEE    _s_i_z_e is invalid (either negative or larger than the
  50.                      maximum allowable queue size).
  51.  
  52.  
  53. NNNNOOOOTTTTEEEE
  54.      On IRIS systems with high-quality audio (e.g. Indigo, Indigo2, and Indy),
  55.      the maximum queue size for a stereo port is currently 131069, the minimum
  56.      queue size for a stereo port is 510; the maximum queue size for a mono
  57.      port is currently 262139, and the minimum queue size for a mono port is
  58.      1019. These values are somewhat nonintuitive. In the future, there should
  59.      be a way to obtain these values from AAAALLLLggggeeeettttmmmmiiiinnnnmmmmaaaaxxxx((((3333ddddmmmm)))) or a similar
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AAAALLLLggggeeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm))))                                        AAAALLLLggggeeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      function. Note that AAAALLLLsssseeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm)))) can succeed if called with values
  75.      outside this range, but AAAALLLLooooppppeeeennnnppppoooorrrrtttt((((3333ddddmmmm)))) will fail due to a bad queue
  76.      size.
  77.  
  78.  
  79. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  80.      Upon successful completion, AAAALLLLggggeeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm)))) returns a non-negative
  81.      number. Otherwise, -1 is returned.
  82.  
  83.      AAAALLLLsssseeeettttqqqquuuueeeeuuuueeeessssiiiizzzzeeee((((3333ddddmmmm)))) returns 0 when successful. Otherwise, it returns -1.
  84.  
  85.      Both functions set an error number which can be retrieved with
  86.      oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))) in the case of failure.
  87.  
  88. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  89.      ALnewconfig(3dm), ALgetconfig(3dm), ALsetconfig(3dm), ALopenport(3dm),
  90.      oserror(3C)
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.